클로드 코드 완벽 가이드 — 부록 99가지 유용한 팁 딥다이브 학습 노트

출처: 클로드 코드 완벽 가이드 (코드팩토리 최지호) | 참고: https://github.com/codefactory-co

전체 흐름도 (ASCII 다이어그램)

[99가지 팁 카테고리 구조]
    |
    +-- 1. 실행 방식 (01~03)
    |       모드 변경 / 플래닝 모드 / YOLO 모드
    |
    +-- 2. 사용법과 도움말 (04~08)
    |       기능 질문 / 프로젝트 분석 / 연동 방법 / 릴리즈 노트 / 상태 구독
    |
    +-- 3. 서브에이전트 (09~13)
    |       멀티에이전트 / 서브에이전트 / 병렬실행 / 커스터마이즈 / 시안
    |
    +-- 4. CLAUDE.md (14~17)
    |       주기적 업데이트 / 요약 / 하위 폴더 / 빠른 메모리
    |
    +-- 5. 내장 기능과 명령어 (18~27)
    |       Tab 자동완성 / /init / /model / 즉시 실행 / 헤드리스
    |       파이핑 / @파일 / Shift 드래그 / -r 대화 / -c 직전 대화
    |
    +-- 6. 이미지와 시각자료 (28~31)
    |       이미지 / 스크린샷 / ASCII 디자인 / Figma MCP
    |
    +-- 7. 작업 및 테스트 자동화 (32~37)
    |       훅 / 자연어 테스트 / QA 자동화 / QA 목표 / E2E / 엣지 케이스
    |
    +-- 8. 토큰 및 요금 관리 (38~43)
    |       Max 플랜 / 모델 선택 / Opus 주의 / 5시간 블록 / Thinking Token / ccusage
    |
    +-- 9. 콘텍스트 관리 (44~47)
    |       콘텍스트 주입 / /clear / /compact / Esc 취소
    |
    +-- 10. MCP (48~52)
    |       MCP 활용 / context7 / Supabase / Sequential Thinking / TossPayments
    |
    +-- 11. 디자인 및 구성요소 (53~55)
    |       디자인 컴포넌트 / URL 입력 / Playwright 크롤링
    |
    +-- 12. 작업 흐름 관리 (56~69)
    |       페르소나 / PRD / 워크트리 / 피드백 루프 / 여러 스텝
    |       되돌리기 / 체크박스 / 작업 확인 / 분할 / 결과물 포맷 / 문서화
    |
    +-- 13. 깃허브 연동 (70~76)
    |       /install-github-app / gh CLI / 이슈 / 세팅 커밋 / PR / 커밋 메시지
    |
    +-- 14. 생산성 전략 (77~86)
    |       항상 허용 / 커스텀 커맨드 / 아규먼트 / 스코프 / 큐
    |       레이어 분리 / 예제 제공 / 코드 검색 / DB 권한 / 경쟁
    |
    +-- 15. 외부 도구 활용 (87~93)
    |       데스크톱 / 슈퍼 클로드 / 스쿼드 / 클로디아 / 스크래치패드
    |       Gemini CLI / IDE 익스텐션
    |
    +-- 16. 개발을 어려워하는 당신에게 (94~99)
            리팩터링 / 여러 옵션 / 분석·추천 / 매니저 역할 / 구독 / 포기하지 말기

선수 지식 체크리스트

• [ ] 클로드 코드 설치 및 기본 사용법 (3장)
• [ ] CLAUDE.md 파일의 역할과 작성법 (5장)
• [ ] 슬래시 커맨드 기본 (/init, /model, /clear 등) (4장)
• [ ] MCP 개념과 설정 방법 (20~24장)
• [ ] 커스텀 커맨드와 훅 기본 개념 (25~27장)
• [ ] Git/GitHub 기본 사용법 (커밋, 브랜치, PR)
• [ ] 터미널 기본 조작 (명령어 입력, 파이프, 플래그)

핵심 키워드

1. 실행 방식 (팁 01~03)

한 줄 요약

클로드 코드의 3가지 실행 모드(일반/자동 승인/플래닝)를 상황에 맞게 전환하면 작업 효율이 극대화된다.

쉬운 설명 (비유로 풀어쓰기)

자동차 기어와 같다. 일반 모드는 수동(매번 내가 확인), 자동 승인은 크루즈 컨트롤(안전한 길에서 자동), YOLO 모드는 자율주행(전부 맡김), 플래닝 모드는 내비게이션(먼저 경로 확인 후 출발)이다.

실무 예제

# 팁 01: Shift+Tab으로 모드 변경
# 일반 → 자동 승인 → 플래닝 모드를 순환 전환

# 팁 02: 플래닝 모드로 복잡한 작업 계획 세우기
# ❌ 바로 코드 작성 시작
claude "회원가입 기능 만들어줘"

# ✅ 플래닝 모드로 먼저 계획 수립
# Shift+Tab → 플래닝 모드 전환 후
claude "회원가입 기능을 만들 건데, 먼저 계획을 세워줘"

# 팁 03: YOLO 모드로 반복 작업 빠르게 처리
# 테스트 코드 작성, 린트 수정 등 안전한 작업에 활용

핵심 체크포인트

• [ ] Shift+Tab으로 모드 전환 방법 숙지
• [ ] 복잡한 작업은 반드시 플래닝 모드 먼저 활용
• [ ] YOLO 모드는 안전한 작업(테스트, 린트)에만 사용

2. 사용법과 도움말 (팁 04~08)

한 줄 요약

클로드 코드에게 직접 기능을 물어보고, 릴리즈 노트와 서비스 상태를 주기적으로 확인하면 최신 기능을 놓치지 않는다.

쉬운 설명 (비유로 풀어쓰기)

스마트폰 설명서를 읽는 대신 시리(Siri)에게 "뭐 할 수 있어?"라고 물어보는 것과 같다. 클로드 코드도 자기 기능을 직접 알려줄 수 있다. 그리고 앱 업데이트 알림처럼, /release 커맨드로 새 기능이 추가됐는지 확인할 수 있다.

실무 예제

# 팁 04: 클로드 코드에게 직접 물어보기
"풀 리퀘스트 만들 수 있어?"
"데이터베이스 연동 가능해?"

# 팁 05: 프로젝트 분석 요청
"이 프로젝트의 전체 구조를 설명해줘"
"src/auth 폴더가 하는 역할을 알려줘"

# 팁 06: 외부 서비스 연동법 질문
"Stripe API 연동하는 방법 알려줘"

# 팁 07: 릴리즈 노트 확인
/release

# 팁 08: Anthropic Status 페이지에서 서비스 상태 확인
# https://status.anthropic.com — RSS, 슬랙으로 알림 구독 가능

핵심 체크포인트

• [ ] 모르는 기능은 클로드 코드에게 직접 질문
• [ ] /release 커맨드로 새로운 기능 주기적 확인
• [ ] 서비스 장애 시 Anthropic Status 페이지 확인

3. 서브에이전트 (팁 09~13)

한 줄 요약

여러 터미널에서 클로드 코드를 동시에 실행하거나, 서브에이전트에게 작업을 위임하면 복잡한 프로젝트를 병렬로 처리할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

요리사 한 명이 모든 요리를 순서대로 하는 대신, 보조 요리사(서브에이전트)에게 "너는 샐러드 담당"이라고 맡기는 것이다. Parallel 키워드를 사용하면 보조 요리사 여러 명이 동시에 다른 요리를 만든다.

실무 예제

# 팁 09: 멀티에이전트 — 터미널 여러 개에서 클로드 코드 실행
# 터미널 1: 프론트엔드 작업
# 터미널 2: 백엔드 작업

# 팁 10: 서브에이전트에게 작업 위임
"인증 관련 파일들을 서브에이전트에게 분석시켜줘"

# 팁 11: 병렬 실행 (Parallel 키워드)
"Parallel로 서브에이전트를 사용해서 다음 3가지를 동시에 해줘:
1. 타입 오류 수정
2. 테스트 코드 작성
3. 문서 업데이트"

# 팁 12: 서브에이전트 커스터마이즈
# CLAUDE.md에 서브에이전트 행동 규칙 정의

# 팁 13: 동시에 여러 시안 받기
"로그인 페이지 디자인을 3가지 스타일로 동시에 만들어줘"

핵심 체크포인트

• [ ] 독립적인 작업은 여러 터미널에서 병렬 실행
• [ ] Parallel 키워드로 서브에이전트 병렬 작업 지시
• [ ] 서브에이전트를 커스터마이즈하여 목적에 맞게 활용

4. CLAUDE.md (팁 14~17)

한 줄 요약

CLAUDE.md는 클로드 코드의 "작업 지침서"로, 주기적 업데이트·요약·하위 폴더 생성·빠른 메모리 추가로 프로젝트 맥락을 정확히 전달한다.

쉬운 설명 (비유로 풀어쓰기)

새 알바생에게 매번 업무를 설명하는 대신 업무 매뉴얼을 만들어두는 것과 같다. CLAUDE.md가 그 매뉴얼이다. 너무 길어지면 요약하고(팁 15), 부서별 매뉴얼이 필요하면 하위 폴더에 따로 만든다(팁 16).

실무 예제

# 팁 14: 주기적 업데이트
"CLAUDE.md를 현재 프로젝트 상태에 맞게 업데이트해줘"

# 팁 15: 요약 (너무 길어졌을 때)
"CLAUDE.md가 너무 길어졌으니 핵심만 남기고 요약해줘"

# 팁 16: 하위 폴더에 CLAUDE.md 생성
# src/auth/CLAUDE.md — 인증 관련 규칙
# src/api/CLAUDE.md — API 관련 규칙

# 팁 17: 빠르게 메모리 추가 (#)
# 프롬프트에 #을 입력하면 CLAUDE.md에 바로 내용 추가
# → "테스트는 반드시 Jest로 작성할 것" 등 즉석 규칙 등록

핵심 체크포인트

• [ ] CLAUDE.md를 프로젝트 요구사항에 맞게 주기적으로 수정
• [ ] 과도하게 길어지면 요약 요청
• [ ] 하위 폴더별 CLAUDE.md로 세분화된 규칙 관리
• [ ] # 입력으로 빠르게 메모리 추가

5. 내장 기능과 명령어 (팁 18~27)

한 줄 요약

Tab 자동완성, /init 초기화, /model 확인, 헤드리스 모드, 파이핑 등 내장 기능을 숙지하면 일상 작업 속도가 비약적으로 빨라진다.

쉬운 설명 (비유로 풀어쓰기)

스마트폰의 단축키를 모르면 매번 설정 앱을 열어야 하지만, 알면 2초 만에 해결된다. 클로드 코드의 내장 명령어도 마찬가지로, 몇 가지 단축키만 익히면 반복 작업이 사라진다.

실무 예제

# 팁 18: 경로 자동완성 — Tab 키 활용
# "src/" 입력 후 Tab → 하위 폴더 자동완성

# 팁 19: 프로젝트 초기화
/init
# → 프로젝트 분석 후 적절한 CLAUDE.md 자동 생성

# 팁 20: 모델 확인 (토큰 절약!)
/model
# ❌ 실수로 Opus 모델에서 간단한 작업 수행 → 토큰 낭비
# ✅ /model로 확인 후 Sonnet으로 전환

# 팁 21: 프롬프트 즉시 실행
claude "issue-20 해결해줘"
# 클로드 코드 시작과 동시에 프롬프트 실행

# 팁 22: 헤드리스 모드 (-p)
claude -p "프로젝트 분석해줘"

# 팁 23: 데이터 주입 파이핑
cat test.md | claude -p "이 마크다운을 분석해줘"

# 팁 24: @로 파일 명시
"@src/auth/login.ts 파일의 버그를 찾아줘"

# 팁 25: Shift 드래그로 파일 참조
# Shift 키를 누른 채 파일을 드래그 앤 드롭

# 팁 26: 기존 대화 재사용 (-r)
claude -r
# 이전 대화 컨텍스트를 이어서 작업

# 팁 27: 직전 대화 재활용 (-c)
claude -c
# 바로 직전 대화로 빠르게 진입

핵심 체크포인트

• [ ] /init으로 새 프로젝트 시작 시 CLAUDE.md 자동 생성
• [ ] /model로 현재 모델 확인 — Opus 낭비 방지
• [ ] -p 헤드리스 모드로 자동화 스크립트 연동
• [ ] @파일명으로 정확한 파일 참조
• [ ] -r과 -c로 이전 대화 이어가기

6. 이미지와 시각자료 활용 (팁 28~31)

한 줄 요약

이미지 드래그, 스크린샷, ASCII 목업, Figma MCP를 활용하면 시각적 디자인 의도를 클로드 코드에 정확히 전달할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

말로 "이런 느낌의 UI"라고 설명하는 것보다, 사진을 보여주는 게 100배 빠르다. 클로드 코드도 이미지를 보고 코드를 작성할 수 있다. Figma 디자인을 바로 코드로 변환하는 것은 디자이너와 개발자 사이의 통역사를 두는 것과 같다.

실무 예제

# 팁 28: 이미지 주입 — 드래그 앤 드롭 또는 Ctrl+V
# 참고 디자인 이미지를 붙여넣기

# 팁 29: UI 스크린샷 활용
# ❌ "버튼 위치가 이상해" (모호함)
# ✅ 스크린샷을 찍어서 "이 부분을 수정해줘" (정확함)

# 팁 30: ASCII 코드로 디자인 목업
"로그인 페이지의 레이아웃을 ASCII로 먼저 보여줘"
# → 텍스트로 빠르게 레이아웃 확인 후 코드 작성

# 팁 31: Figma MCP 연동
# Figma에서 제작한 디자인을 MCP로 연결
# → 디자인 → 코드 자동 변환

핵심 체크포인트

• [ ] UI 문제는 스크린샷으로 전달하면 정확도 향상
• [ ] 복잡한 디자인 전에 ASCII 목업으로 구조 먼저 확인
• [ ] Figma MCP로 디자인-코드 간극 줄이기

7. 작업 및 테스트 자동화 (팁 32~37)

한 줄 요약

훅(Hook)으로 작업 완료 시 자동 테스트를 실행하고, 자연어로 테스트 조건을 기술하며, E2E 및 엣지 케이스까지 포함하면 코드 품질이 비약적으로 향상된다.

쉬운 설명 (비유로 풀어쓰기)

공장의 자동 품질 검사 라인과 같다. 제품(코드)이 만들어질 때마다 자동으로 검사(테스트)가 돌아가고, "불량이면 알려줘"라고 설정해두는 것이 훅이다.

실무 예제

# 팁 32: 클로드 코드 훅 — 작업 완료마다 테스트 실행
# .claude/settings.local.json에 훅 설정
# → 코드 변경 시 자동으로 린트 + 테스트

# 팁 33: 자연어로 테스트 자동화
# ❌ 테스트 코드를 직접 작성
# ✅ "로그인 실패 시 에러 메시지가 표시되는지 테스트해줘"

# 팁 34: QA 자동화
"테스트, 린트, 빌드를 실행하고 결과 기반으로 코드를 개선해줘"

# 팁 35: QA 목표 지정
"유닛 테스트 커버리지 80% 이상이 될 때까지 테스트 코드 작성해줘"

# 팁 36: E2E 테스트
"Playwright로 회원가입 → 로그인 → 대시보드 접근 E2E 테스트 만들어줘"

# 팁 37: 엣지 케이스 포함 요청
"엣지 케이스도 포함해서 더 상세한 테스트 케이스를 만들어줘"

핵심 체크포인트

• [ ] 훅으로 코드 변경 시 자동 테스트/린트 실행
• [ ] 테스트 조건을 자연어로 기술하여 테스트 코드 자동 생성
• [ ] QA 목표(커버리지 등)를 명시적으로 지정
• [ ] E2E 테스트와 엣지 케이스까지 요청

8. 토큰 및 요금 관리 (팁 38~43)

한 줄 요약

작업 난이도에 맞는 모델을 선택하고, 5시간 블록을 전략적으로 운영하며, ccusage로 사용량을 모니터링하면 비용 대비 최대 효율을 얻는다.

쉬운 설명 (비유로 풀어쓰기)

택시(Opus)와 버스(Sonnet)의 차이다. 급한 회의에는 택시를 타지만, 출퇴근에는 버스가 훨씬 경제적이다. 그리고 교통카드 잔액 확인(ccusage)은 필수다.

실무 예제

# 팁 38: Max 플랜 고려
# 토큰 한계에 자주 부딪히면 Pro($20) → Max($100) 업그레이드 고려

# 팁 39: 작업에 어울리는 모델 사용
# ❌ 간단한 코드에도 항상 Opus 사용
# ✅ Opus: 버그 해결, 복잡한 플래닝 / Sonnet: 일상 코드 작성

# 팁 40: Opus 무조건 선호하지 않기
# Opus는 강력하지만 느림 → 가능하면 Sonnet 사용

# 팁 41: 5시간 블록 전략적 운영
# 클로드 코드는 처음 사용부터 5시간 토큰 제한
# → 작업 패턴에 맞춰 적절한 시간대에 첫 요청

# 팁 42: Thinking Token 활용
# Think → Think Hard → Think Harder → Ultrathink
# 순서대로 더 많은 추론 토큰 할당

# 팁 43: ccusage로 토큰 모니터링
# ccusage 도구를 설치하여 실시간 사용량 확인

핵심 체크포인트

• [ ] 간단한 작업은 Sonnet, 복잡한 작업은 Opus
• [ ] /model로 현재 모델을 수시로 확인
• [ ] 5시간 블록의 시작 시점을 전략적으로 선택
• [ ] Thinking Token으로 추론 깊이 조절
• [ ] ccusage로 토큰 사용량 주기적 확인

9. 콘텍스트 관리 (팁 44~47)

한 줄 요약

충분한 콘텍스트를 먼저 주입하고, /clear와 /compact로 관리하며, 잘못된 작업은 Esc로 즉시 취소하면 콘텍스트 오염을 방지할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

책상 위에 필요한 서류만 올려두는 것과 같다. 너무 많은 서류(콘텍스트)가 쌓이면 혼란스러워지니, 주기적으로 정리(/clear)하거나 압축(/compact)한다. 잘못된 서류가 올라왔다면 바로 치운다(Esc).

실무 예제

# 팁 44: 콘텍스트 주입
# ❌ "회원가입 수정해줘" (맥락 없음)
# ✅ "회원가입 관련 파일(@src/auth)을 먼저 분석하고, 이메일 검증 로직을 수정해줘"

# 팁 45: /clear — 대화 콘텍스트 리셋
/clear
# 완전히 다른 작업으로 넘어갈 때 사용

# 팁 46: /compact — 콘텍스트 압축
/compact
# 콘텍스트가 부족할 때 자동 압축보다 직접 실행이 효율적

# 팁 47: Esc — 잘못된 작업 즉시 취소
# 클로드 코드가 잘못된 방향으로 가고 있으면 Esc로 중단
# → 잘못된 작업을 했다고 알려줘야 콘텍스트 오염 방지

핵심 체크포인트

• [ ] 작업 전 관련 파일·컨텍스트를 먼저 분석 지시
• [ ] 작업 전환 시 /clear로 콘텍스트 리셋
• [ ] 콘텍스트 부족하면 /compact로 직접 압축
• [ ] 잘못된 작업은 즉시 Esc → "잘못했다"고 명시

10. MCP (팁 48~52)

한 줄 요약

MCP(Model Context Protocol)를 통해 context7, Supabase, Sequential Thinking, TossPayments 등 외부 서비스를 클로드 코드에 연결하면 기능이 대폭 확장된다.

쉬운 설명 (비유로 풀어쓰기)

스마트폰에 앱을 설치하는 것과 같다. 기본 기능만으로도 쓸 수 있지만, 카카오맵(context7), 은행앱(Supabase), 결제앱(TossPayments)을 설치하면 할 수 있는 일이 훨씬 많아진다.

실무 예제

# 팁 48: MCP 활용 — 클로드 코드의 기능 확장
# 공식 문서 검색, DB 조회, 결제 연동 등

# 팁 49: context7 MCP — 최신 공식 문서 검색
# → "React 19의 use() 훅 사용법" 같은 최신 정보 조회

# 팁 50: Supabase MCP
# → 데이터베이스 연동, 인증, 스토리지 등 Supabase 기능 직접 사용

# 팁 51: Sequential Thinking MCP
# → 클로드 코드가 더욱 체계적으로 사고하도록 유도

# 팁 52: TossPayments MCP
# → 결제 연동 작업을 MCP로 간편하게 처리
# 대한민국 PG사 중 최초의 MCP

핵심 체크포인트

• [ ] MCP로 클로드 코드의 기능 범위를 확장
• [ ] context7로 최신 공식 문서 정보 활용
• [ ] Supabase MCP로 백엔드 기능 빠르게 구축
• [ ] 프로젝트에 필요한 MCP를 선별적으로 설치

11. 디자인 및 구성요소 (팁 53~55)

한 줄 요약

디자인 컴포넌트 데모 페이지를 먼저 만들고, URL과 Playwright 크롤링으로 참고 사이트의 디자인을 JSON으로 정리하면 일관된 UI를 빠르게 제작할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

옷을 만들기 전에 패턴(본)을 먼저 만드는 것과 같다. 디자인 컴포넌트 데모 페이지가 패턴이고, 참고 사이트를 Playwright로 크롤링하는 것은 패션 잡지에서 스타일을 참고하는 것이다.

실무 예제

# 팁 53: 디자인 컴포넌트 데모 페이지
"디자인 컴포넌트 데모 페이지를 먼저 만들어줘 — 버튼, 카드, 폼 등"

# 팁 54: 웹사이트 URL 입력
"https://example.com의 레이아웃을 참고해서 만들어줘"

# 팁 55: Playwright로 웹사이트 크롤링
"이 사이트를 Playwright로 크롤링해서 테마를 JSON으로 정리해줘"
# → 색상, 폰트, 간격 등을 구조화된 데이터로 추출

핵심 체크포인트

• [ ] 코드 작성 전 디자인 컴포넌트 데모 페이지 먼저 생성
• [ ] 참고 사이트 URL을 직접 전달하여 디자인 참고
• [ ] Playwright로 크롤링한 JSON을 디자인 시스템에 활용

12. 작업 흐름 관리 (팁 56~69)

한 줄 요약

페르소나 부여, PRD 작성, 워크트리 활용, 피드백 루프, 체크박스 모니터링 등 체계적인 작업 흐름을 설계하면 프로젝트 관리와 코드 품질이 동시에 향상된다.

쉬운 설명 (비유로 풀어쓰기)

건물을 짓는 과정과 같다. PRD는 설계도(팁 57), 페르소나는 전문가 역할(팁 56), 피드백 루프는 시공→검수→보완 반복(팁 59), 체크박스는 공정표(팁 62), 작업 분할은 층별 공사(팁 65)다.

실무 예제

# 팁 56: 페르소나 부여
"너는 시니어 백엔드 개발자야. FastAPI로 인증 시스템을 설계해줘"

# 팁 57: PRD 먼저 작성
"프로젝트의 PRD를 먼저 작성하고, 적절한 CLAUDE.md를 만들어줘"

# 팁 58: 워크트리 활용
# 메인 브랜치에 영향 없이 독립된 브랜치에서 실험

# 팁 59: 피드백 루프 (계획→작업→확인→수정)
# CLAUDE.md에 피드백 루프 규칙 기록

# 팁 60~61: 여러 스텝에 걸쳐 작업 / Esc 2번으로 되돌리기

# 팁 62: 마크다운 체크박스로 진행 모니터링
# - [x] DB 스키마 설계
# - [ ] API 엔드포인트 구현
# - [ ] 프론트엔드 연동

# 팁 63: 작업 사항 확인 — 과도한 신뢰 방지

# 팁 64: 작업 되돌리기
"방금 작업이 마음에 안 드니 이전 상태로 되돌려줘"

# 팁 65: 작업 분할
"이 작업을 작은 단위로 분할해줘"

# 팁 66: 작업하지 말라고 하기 (계획만)
"코드는 작성하지 말고, 계획만 먼저 세워줘"

# 팁 67: 결과물 포맷 지정
"결과를 JSON 형식으로 출력해줘"

# 팁 68: 작업 파일로 저장
# 한 콘텍스트에서 끝낼 수 없으면 마크다운 파일에 진행 기록

# 팁 69: 문서화 자주하기
"README.md와 마이그레이션 가이드를 정리해줘"

핵심 체크포인트

• [ ] 복잡한 작업은 PRD 먼저 작성
• [ ] 페르소나로 역할을 명확히 부여
• [ ] 워크트리로 안전한 실험 환경 확보
• [ ] 체크박스로 작업 진행 상황 시각적 관리
• [ ] YOLO 모드에서는 "계획만 세워줘"가 특히 유용

13. 깃허브 연동 (팁 70~76)

한 줄 요약

GitHub App 설치, gh CLI 연동, 이슈 관리, 세팅 커밋, PR 생성, 커밋 메시지 자동화까지 Git 워크플로우 전체를 클로드 코드로 자동화할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

비서가 회의록(커밋 메시지)을 정리하고, 보고서(PR)를 올리고, 할일 목록(이슈)을 관리해주는 것과 같다. 클로드 코드가 Git 전담 비서 역할을 한다.

실무 예제

# 팁 70: GitHub App 설치
/install-github-app
# → PR 리뷰, 이슈 해결에 클로드 활용

# 팁 71: GitHub CLI 설치
# gh CLI 설치 → 현재 리포지터리 정보 자동 연동

# 팁 72: 이슈 활용
"GitHub 이슈 #15를 해결해줘"

# 팁 73: 프로젝트 세팅 커밋
# 커스텀 커맨드, 클로드 코드 세팅을 커밋 → 팀 공유

# 팁 74: PR 생성 요청
"풀 리퀘스트를 만들어줘"
# → 지금까지의 커밋 기반으로 PR 자동 생성

# 팁 75: 커밋 메시지 부탁하기
"커밋 메시지를 작성해줘"

# 팁 76: 자주 커밋하기
"작업하면서 자주 커밋해달라고" 요청
# → 특정 시점으로 쉽게 되돌리기 가능

핵심 체크포인트

• [ ] /install-github-app으로 GitHub 연동
• [ ] gh CLI 설치로 리포지터리 정보 자동 인식
• [ ] 이슈 번호를 직접 지정하여 작업 지시
• [ ] 프로젝트 세팅(커스텀 커맨드 등)을 커밋하여 팀 공유
• [ ] 자주 커밋하여 되돌리기 안전망 확보

14. 생산성 전략 (팁 77~86)

한 줄 요약

항상 허용 등록, 커스텀 커맨드, 레이어 분리, 예제 제공, 코드 경쟁 등의 전략으로 반복 작업을 줄이고 결과 품질을 높인다.

쉬운 설명 (비유로 풀어쓰기)

요리를 빠르게 하려면 자주 쓰는 양념은 앞에 배치(항상 허용)하고, 레시피를 저장(커스텀 커맨드)하고, 메인·사이드·디저트를 나눠서(레이어 분리) 동시에 준비하는 것과 같다.

실무 예제

# 팁 77: 항상 허용 등록
# 안전한 커맨드(ls, git status 등)는 "항상 허용" 선택

# 팁 78: 커스텀 커맨드 등록
# /my-deploy, /my-test 등 자주 쓰는 프롬프트를 등록

# 팁 79: 커스텀 커맨드에 아규먼트 사용
# /fix-bug issue-20  ← "issue-20"이 아규먼트로 전달

# 팁 80: 적절한 스코프 사용
# 사용자 스코프 / 프로젝트 스코프 / 로컬 스코프 구분

# 팁 81: 프롬프트 큐에 적재하기
# 현재 작업 실행 중에 다음 프롬프트를 미리 입력

# 팁 82: 레이어별로 작업시키기
# ❌ "프론트+백엔드+DB 한 번에 만들어줘"
# ✅ "먼저 DB 스키마만 만들어줘" → "API만 만들어줘" → "프론트만 만들어줘"

# 팁 83: 예제 제공
# ❌ "카드 컴포넌트 만들어줘"
# ✅ "이 예제(@components/Card.tsx)를 참고해서 비슷한 스타일로 만들어줘"

# 팁 84: 관련 코드 찾아달라고 하기
"인증 관련 파일과 관련 함수들을 찾아줘"

# 팁 85: DB 조회 권한 주기 (MCP)
# PostgreSQL/MySQL MCP로 DB 조회 → 효율적 디버깅

# 팁 86: 클로드 코드끼리 경쟁시키기
# 터미널 2개: 하나는 코드 작성, 하나는 코드 검증

핵심 체크포인트

• [ ] 안전한 명령어는 "항상 허용"으로 시간 절약
• [ ] 자주 쓰는 프롬프트를 커스텀 커맨드로 등록
• [ ] 작업을 레이어(DB→API→프론트)별로 분리
• [ ] 기존 코드 예제를 제공하면 결과 품질 향상
• [ ] 두 개의 클로드 코드로 작성-검증 병렬 수행

15. 외부 도구 활용 (팁 87~93)

한 줄 요약

클로드 데스크톱, 슈퍼 클로드, 클로드 스쿼드, 클로디아, 스크래치패드 등 외부 생태계 도구를 함께 사용하면 CLI 한계를 넘어선 생산성을 확보할 수 있다.

쉬운 설명 (비유로 풀어쓰기)

클로드 코드가 메인 컴퓨터라면, 외부 도구들은 보조 모니터·키보드 매크로·클라우드 스토리지 같은 주변기기다. 각각 특화된 기능이 있어 함께 쓰면 훨씬 강력하다.

실무 예제

# 팁 87: 클로드 데스크톱 — 긴 작업에서 문맥 유지
# CLI + 데스크톱 앱 함께 사용

# 팁 88: 슈퍼 클로드 — 파인 튜닝된 커스텀 커맨드 모음
# 무료 오픈소스, 설치 후 바로 사용 가능

# 팁 89: 클로드 스쿼드 — 워크트리를 더 편하게
# 워크트리 사용이 어려우면 스쿼드로 간소화

# 팁 90: 클로디아 — 에이전트를 저장·재사용
# 프레임워크 부트스트래핑 등 반복 작업을 에이전트화

# 팁 91: 스크래치패드 — 작업 과정을 시각적으로
"스크래치패드를 사용해서 작업해줘"

# 팁 92: Gemini CLI 등 다른 에이전트 병용
# 클로드 코드 + Gemini CLI → 토큰/콘텍스트 절약

# 팁 93: IDE 익스텐션 설치
# VS Code 등에 클로드 코드 익스텐션 설치
# → 현재 프로젝트의 선택 영역을 바로 작업

핵심 체크포인트

• [ ] CLI가 불편한 장기 작업은 클로드 데스크톱 병용
• [ ] 슈퍼 클로드로 검증된 커스텀 커맨드 세트 활용
• [ ] 클로디아로 자주 쓰는 작업 패턴을 에이전트화
• [ ] 다른 AI CLI 도구와 병용하여 비용 최적화

16. 개발을 어려워하는 당신에게 (팁 94~99)

한 줄 요약

리팩터링 요청, 여러 옵션 비교, AI 분석·추천 기능을 적극 활용하고, 매니저 관점으로 전환하면 개발 경험이 부족해도 높은 품질의 결과물을 만들 수 있다.

쉬운 설명 (비유로 풀어쓰기)

초보 운전자도 좋은 내비게이션(클로드 코드)이 있으면 목적지에 도착할 수 있다. 리팩터링(팁 94)은 내비가 더 빠른 길을 알려주는 것, 여러 옵션(팁 95)은 경로 3개를 보여주는 것, 매니저 역할(팁 97)은 운전보다 목적지를 정하는 데 집중하는 것이다.

실무 예제

# 팁 94: 자주 리팩터링 요청
"이 코드를 더 효율적으로 리팩터링해줘"
# 클로드 코드는 리팩터링을 매우 잘함

# 팁 95: 여러 옵션 요구
"카드 디자인을 개선할 수 있는 5가지 방법을 보여줘"

# 팁 96: 분석시키고 추천받기
"A 방식과 B 방식 중 어떤 것이 나은지 분석해서 추천해줘"

# 팁 97: 매니저 역할로 전환
# 코드를 직접 쓰는 게 아니라, 방향을 제시하고 검토하는 역할

# 팁 98: 코드팩토리 유튜브 구독
# 꿀팁 지속 업데이트

# 팁 99: 포기하지 말기!
# AI와 함께 코딩하는 기술도 경험이 쌓이면 엄청난 효율 발휘

핵심 체크포인트

• [ ] 코드가 복잡해지면 주기적으로 리팩터링 요청
• [ ] 한 가지 방법 대신 여러 옵션을 비교하여 선택
• [ ] 고민이 되면 분석·추천을 받아 의사결정
• [ ] 개발자→매니저 마인드셋 전환
• [ ] 포기하지 않고 꾸준히 AI 코딩 경험 쌓기

연습문제

문제 1: 모델 선택과 비용 최적화

다음 작업 목록에서 각각 Opus와 Sonnet 중 적합한 모델을 선택하고 이유를 설명하세요.

문제 2: 콘텍스트 관리 시나리오

클로드 코드로 3시간 동안 인증 기능을 개발한 후, 이제 결제 기능을 개발하려 합니다. 가장 적절한 콘텍스트 관리 전략을 순서대로 나열하세요.

문제 3: 실전 작업 흐름 설계

새로운 할일 관리 앱(Todo App)을 처음부터 만든다고 가정합니다. 99가지 팁 중 활용할 수 있는 팁을 최소 10개 이상 순서대로 나열하고, 각 단계에서 어떻게 활용하는지 설명하세요.

부록 A — 용어 사전

부록 B — 비교표

실행 모드 비교

모델 선택 가이드

콘텍스트 관리 명령어 비교

외부 도구 비교

부록 C — 참고 자료

• 공식 문서: Claude Code Documentation
• 서비스 상태: Anthropic Status
• 저자 GitHub: https://github.com/codefactory-co
• 코드팩토리 유튜브: https://www.youtube.com/@codefactory
• context7 MCP: https://github.com/upstash/context7
• ccusage: https://github.com/ryoppippi/ccusage
• 슈퍼 클로드: https://github.com/superclaude
• 책 정보: 요즘 바이브 코딩 — 클로드 코드 완벽 가이드 (골든래빗, 2025)